home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / skim102.zip / SKIM.DOC < prev    next >
Text File  |  1989-08-04  |  9KB  |  264 lines
  1.  
  2.  
  3.  
  4.           
  5.           
  6.                                 >>>>> SKIM >>>>>
  7.                            A TEXT FILE SEARCH UTILITY
  8.           
  9.           Previously released as "SCAN"
  10.           
  11.           Copyright notice and Registration info:
  12.           
  13.           All rights reserved, copyright 1988, 89 by Brian H. Lawler.
  14.           
  15.           This software and documentation may be freely distributed in 
  16.           UNMODIFIED form. Alteration of the program code or
  17.           documentation or inclusion of same in any commercial
  18.           application without the written consent of LAWLER
  19.           MICROSYSTEMS is expressly forbidden.
  20.           
  21.           A thirty day conditional license is granted to the user at
  22.           no charge for the purpose of evaluating this product. You
  23.           may obtain a perpetual conditional license by completing the 
  24.           registration form and returning it to LAWLER MICROSYSTEMS.
  25.           There is NO CHARGE for registering your copy of SKIM. You
  26.           may receive a current revision (specify 5 1/4 or 3 1/2 inch
  27.           diskette) of SKIM by remitting five dollars (US) to LAWLER
  28.           MICROSYSTEMS, #3 Evergreen Drive, St. Joseph, MO 64505-9661. 
  29.           PLEASE do not send disks, mailers, or stamps. Foreign orders 
  30.           are $10 U.S.
  31.           
  32.           
  33.           What SKIM does:
  34.           
  35.           SKIM is a simple text-file searching program. Give SKIM the
  36.           name of the file to search and the string to look for and           
  37.           the program will do the rest. There are a number of
  38.           utilities out there that perform a similar function but none 
  39.           (that I have seen) provide the output format of SKIM.                         
  40.           I wrote SKIM as a utility for searching a textfile
  41.           containing a list of 12000+ public domain programs and
  42.           descriptions. Rather than write a full-blown database I
  43.           decided that all I really needed was a fast query
  44.           capability. SKIM will list all lines containing a given
  45.           sub-string. Using the public domain list as an example you
  46.           might query all programs relating to assembly language by
  47.           SKIMming for 'ASM'.
  48.           
  49.           
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.   1  
  66.  
  67.  
  68.  
  69.  
  70.           
  71.           SKIM's Syntax
  72.           
  73.           SKIM [input-file] [search-string]
  74.           
  75.           SKIM may be invoked alone, or with one or both of the
  76.           perameters. Any parameters not specified on the command line 
  77.           will be obtained at run-time.
  78.           
  79.           INPUT-FILE - This is the name of the text file to be
  80.           searched. Up to 40 characters are allowed for the file name
  81.           with optional DOS pathname. The file is ASSUMED to consist
  82.           of a series of text lines not exceeding 80 characters in
  83.           length. Characters beyond the 80th will be ignored. File
  84.           length is un-limited. The INPUT-FILE is NOT altered in any
  85.           way by SKIM.
  86.           
  87.           SEARCH-STRING - This is the word, text, or character group
  88.           to look for in each line of the input-file. The
  89.           search-string may be up to 40 characters in length and is
  90.           NOT CASE SENSITIVE. i.e. "Test" would match both "test" and
  91.           "TEST". SPECIAL NOTE: When specifying the search-string on
  92.           the command line the string must consist of continuous
  93.           characters (no spaces allowed). To include spaces in the
  94.           search invoke SKIM with-out the command line search
  95.           parameter. This is important, for example, if you are
  96.           looking for references to the "C" language. {SKIM test.txt
  97.           c} would match EVERY LINE in "test.txt" that contained the
  98.           letter "c". Invoking SKIM and later specifying
  99.           {space}c{space} would only match lines where "c" or "C" are
  100.           bound by spaces. 
  101.           
  102.           OUTPUT-FILE - This is OPTIONAL. If you simply want to review 
  103.           the matches on the screen press RETURN. The matching lines
  104.           will scroll up, stopping at each screen-full waiting for a
  105.           keypress to continue. If you so desire, the output can be
  106.           re-directed to a DOS path/file-name of up to 40 characters.
  107.           The output file will consist of copies of all of the lines
  108.           from the input-file that contained the search-string (even
  109.           if the search-string appears more than once in a line it is
  110.           only displayed or written ONCE). Screen output will be
  111.           suppressed except for the summary.
  112.           
  113.           SPECIAL NOTE: If output-file does not exist, it is created.
  114.           If it DOES exist it is PRESERVED and the new lines are
  115.           APPENDED to it. This allows you to Search for multiple
  116.           related strings and have all of the output in ONE FILE for
  117.           later review.
  118.           
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.   2  
  132.  
  133.  
  134.  
  135.  
  136.           
  137.           REGISTRATION FORM for SKIM
  138.           
  139.           Complete and mail to:LAWLER MICROSYSTEMS
  140.                                #3 Evergreen Drive
  141.                                Saint Joseph, MO  64505-9661
  142.                                (816) 232-0286
  143.           
  144.           Completion and mailing of this form (or facsimile thereof)
  145.           constitutes legal registration of SKIM. NO FEE is required
  146.           or requested BUT I would never turn away a buck or two!
  147.           
  148.           NAME:   _______________________________________________
  149.           Address:_______________________________________________
  150.                   _______________________________________________
  151.           City    ________________________  , _____ ZIP ____________
  152.           
  153.           Phone:             (optional)  (_____)  _____-__________
  154.           
  155.           SKIM Version #  1.02  /  _______
  156.           
  157.           Where did you obtain SKIM? (if BBS give telephone #)
  158.           ___________________________________________________________
  159.           Computer MAKE: ________________________________
  160.           MODEL: _________________________________ 
  161.           Configuration (Drives, etc) _______________________________
  162.           ___________________________________________________________
  163.           ___________________________________________________________
  164.           
  165.           
  166.           What enhancements or changes would you like to see in SKIM?
  167.           ___________________________________________________________
  168.                        
  169.           ___________________________________________________________
  170.           
  171.           General comments: ________________________________________
  172.           
  173.           ___________________________________________________________
  174.                        
  175.           ________________________________________________
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.   3  
  198.  
  199.  
  200.  
  201.  
  202.           
  203.           Ramblings....
  204.           
  205.           Q: Why ANOTHER search utility?!?
  206.           
  207.           A: I recently started using a BIG BBS (Executive PC) that
  208.           has over 12,000 files available for download. I wanted an
  209.           easy way to scan that 900K directory for stuff that
  210.           interested me. I like Norton's Text-Search but it is a
  211.           "general purpose" searcher. It is not line oriented, stops
  212.           after EVERY match, and has annoying screen attributes
  213.           (flash-flash). SKIM is tuned to it's special function as a
  214.           LINE ORIENTED utility and still manages to keep close pace
  215.           with TS (about 5% slower by my benchmarks).
  216.           
  217.           
  218.           TECHNICAL STUFF:
  219.           
  220.           SKIM is written in Microsoft Quick C 2.0. There is no "fancy 
  221.           screen-work" in version 1.02 so it SHOULD work on many
  222.           less-than-100% compatibles. In the interest of speed &
  223.           efficiency SKIM digests the source file in 16K pieces
  224.           (buffer-size). You can tell the progress of the program by
  225.           seeing the drive light blink every 16,384 characters. I
  226.           experimented with different buffer sizes but found 16K to
  227.           perform as well as 32K on my 12 Mhz AT class rice-burner.
  228.           Quick-C's default buffer of 512 BYTES was a definite
  229.           bottle-neck; slowing performance by nearly 500%                                     
  230.           
  231.           
  232.           TIPS TO EXEC-PC USERS:
  233.           
  234.           Download and un-arc all of the XFER?.ARC files to prepare
  235.           them for SKIM. Assuming you have 1 Meg+ of disk space, use
  236.           the DOS COPY command to CONCATENATE all of the separate
  237.           files into one BIG one. COPY newest.txt+older.txt+oldest.txt 
  238.           (etc...)  BIGFILE.TXT Once you have them all you can add the 
  239.           new files (XFERM.ARC) every month to keep updated. Be sure
  240.           to concatenate in the proper order to maintain the date
  241.           sort.
  242.           
  243.           SKIM was previously released as SCAN100 via the EXEC-PC BBS
  244.           and was renamed to avoid confusion with another program.
  245.           
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.   4  
  264.